home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / intro.0 < prev    next >
Text File  |  1996-09-02  |  4KB  |  67 lines
  1. This  is a description of how to actually use the screen package.
  2. For simplicity, we assume all updating, reading, etc.  is applied
  3. to  although  a  different window can of course be specified.  In
  4. order to use the screen package, the  routines  must  know  about
  5. terminal  characteristics, and the space for and must be allocat-
  6. ed.  These functions are performed  by  Since  it  must  allocate
  7. space for the windows, it can overflow core when attempting to do
  8. so.  On this rather rare occasion, returns ERR.  must  be  called
  9. before  any of the routines which affect windows are used.  If it
  10. is not, the program will core dump as soon as either or are  ref-
  11. erenced.   However,  it  is usually best to wait to call it until
  12. after you are sure you will need  it,  like  after  checking  for
  13. startup  errors.   Terminal  status  changing  routines  like and
  14. should be called after After the initial window  allocation  done
  15. by  specific window characteristics can be set.  Scrolling can be
  16. enabled by calling If you want the cursor to be  left  after  the
  17. last  change, use If this isn't done, will move the cursor to the
  18. window's current  after updating it.  Additional windows  can  be
  19. created  by  using  the functions and allows you to delete an ex-
  20. isiting window.  The variables and control the size of the termi-
  21. nal.  They are initially implicitly set by but can be altered ex-
  22. plicitly by the user followed by a call to Note that any call  to
  23. will  always  delete any existing and/or before creating new ones
  24. so this change is best done before the initial call to The  basic
  25. functions  used to change what will go on a window are and adds a
  26. character at the current , returning ERR if it  would  cause  the
  27. window  to  illegally  scroll,  printing a character in the lower
  28. right-hand corner of a terminal which  automatically  scrolls  if
  29. scrolling  is  not allowed.  changes the current  to whatever you
  30. want them to be.  It returns ERR if you try to move off the  win-
  31. dow.  As mentioned above, you can combine the two into to do both
  32. things in one call.  The other output functions (such as and  all
  33. call  to  add  characters to the window.  After a change has been
  34. made to the window, you must call when you want  the  portion  of
  35. the terminal covered by the window to reflect the change.  In or-
  36. der to optimize finding changes, assumes that  any  part  of  the
  37. window  not  changed  since  the last of that window has not been
  38. changed on the terminal, that you have not refreshed a portion of
  39. the  terminal  with  an  overlapping  window.  If this is not the
  40. case, the routines and are provided to make it look  like  a  de-
  41. sired part of window has been changed, thus forcing to check that
  42. whole subsection of the terminal for changes.  If you  call  with
  43. it will make the screen look like the image of This is useful for
  44. implementing a command which would redraw the screen in  case  it
  45. got  messed  up.   Input is essentially a mirror image of output.
  46. The complementary function to is which, if echo is set, will call
  47. to  echo  the  character.  Since the screen package needs to know
  48. what is on the terminal at all times, if  characters  are  to  be
  49. echoed,  the  tty  must  be in raw or cbreak mode.  If it is not,
  50. sets it to be cbreak, and then reads in the character.  In  order
  51. to perform certain optimizations, and, on some terminals, to work
  52. at all, some things must be done before the screen routines start
  53. up.   These functions are performed in and which are called by In
  54. order to clean up after the routines, the  routine  is  provided.
  55. It  restores  tty  modes to what they were when was first called.
  56. The terminal state module uses the variable to save the  original
  57. terminal  state  which is then restored upon a call to Thus, any-
  58. time after the call to initscr, should be called before  exiting.
  59. Note  however,  that  should  always be called the final calls to
  60. which free the storage of the windows.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.